home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / music / karaok25.zip / KARAOKE.DOC < prev    next >
Text File  |  1993-11-22  |  14KB  |  304 lines
  1.  
  2.                               *********************
  3.                               *      KARAOKE      *
  4.                               *********************
  5.                                   Version  2.50
  6.                                    User Manual
  7.  
  8.                         (c) 1992, 93 dgs software / music
  9.                               an ExCiTe! production
  10.  
  11.  
  12.  
  13. Author       : Davide Guida (DGS)
  14. Address      : Via Rodolfo Falvo 10, Napoli (Italy)
  15. E-MAIL       : progetto@csdux01.cised.unina.it
  16.                (see paragraph #9 for E-MAIL instructions)
  17. Release Date : November 22nd, 1993
  18.  
  19.  
  20.  
  21. 1. WHAT IS KARAOKE
  22.  
  23. Originally, Karaoke is a popular music game for discos or beaches allowing you,
  24. 'common people', to sing your favorite song while listening the original music
  25. background. So any people can learn songs easier and faster, having fun in the
  26. world of music. KARAOKE became very popular in Italy last year, due to a tv
  27. show broadcast on Italia Uno(*) Network, showing people from all italian towns
  28. trying to sing in front of tv-camera and to win a prize for the best karaoker
  29. in the week.
  30.  
  31. My program KARAOKE is based on the same concept, but you should have a PC, a
  32. sound card and a lot of .MOD music files to play: if you have a lot of popular
  33. songs, and you know their lyrics, you can create a data file for this program
  34. so you can sing over the module while your PC displays song lyrics.
  35.  
  36. (*) Italia Uno Network and its logo are registered trademarks of R.T.I. [Reti
  37.     Televisive Italiane]
  38.  
  39.  
  40. 2. HARDWARE REQUIRED FOR USING KARAOKE
  41.  
  42. In order to use KARAOKE you need the following hardware:
  43.  
  44. - PC 386/486, 16MHz or better. 640k RAM needed. No Expanded Memory reqyired.
  45. - Hard disk with 400k space free.
  46. - Sound Blaster (Normal, Pro or 16), Pro Audio Spectrum or Aria Sound Card.
  47. - VGA Card, with at least 256k memory.
  48. - Mouse recommended, but not needed.
  49.  
  50. NOTE: 286 users must download KARAOKE versions previous than 2.00. This
  51.       version supports only 386 and 486 machines. Karaoke v1.0 is available
  52.       via Anonymous FTP Sites.
  53.  
  54. In order to install KARAOKE, you must create a directory on your hard disk
  55. and unzip distribution file (KARAOK25.ZIP) into it. Then, type KARAOKE and
  56. press <ENTER> to run it.
  57.  
  58.  
  59. 3. HOW TO USE KARAOKE
  60.  
  61. KARAOKE is easy to use. You can play 15-channel SoundTracker Modules (.MOD),
  62. 31-channel 4-voice NoiseTracker modules (.MOD), Multi-channel FastTracker
  63. modules (.8CM and .6CM), Scream-Tracker 2.0 and 3.0 files (.STM and .S3M)
  64. and Otto Chrons' .AMF modules.
  65.  
  66. After the intro screen, the main menu will be displayed. Four options can be
  67. choosen. You can select them by keyboard on by clicking the mouse on its icon.
  68.  
  69. <Device> : you can select sound devices and its parameters. A new group of
  70.            icons will be displayed, indicating all devices supported by
  71.            Karaoke. You can press function keys to select a device or click
  72.            on a icon. Select <Main Menu> or press <Esc> to come back to main
  73.            menu. Then, you can select sound parameters as if you click on
  74.            <Options> icon (see below for explanation).
  75. <Song>   : allows you to select a module and play it.
  76. <Options>: allows you to set all parameters needed to configure your sound
  77.            card and device playback. First parameter is the frequency mix
  78.            rate (that is, playback frequency): values depend from sound card
  79.            and computer speed. Use WHICH utility in order to know possible
  80.            values for your card. SoundBlaster 16 and Pro Audio Spectrum Cards
  81.            can pump frequency rate up to 44,1KHz. Other parameters are the
  82.            master volume (in the range 1-63) and sound parameters like I/O
  83.            base address, dma channel and dma irq line. Default values for all
  84.            parameters are:
  85.                     * Frequency    -  16000 Hz
  86.                     * Volume       -  64
  87.                     * I/O Address  -  0220h
  88.                     * DMA Irq      -  5
  89.                     * DMA Channel  -  1
  90.            Note : I/O Address must be specified with its hexadecimal value.
  91. <Quit>   : exit to DOS. ALT-X is also allowed to perform this operation.
  92.  
  93. You can choose a module from your disk by selecting <Song> option and by
  94. using the file requester. You can use arrow keys or click on buttons shown
  95. on the right. Press <ESC> to abort the operation, or <Enter> to select a
  96. module.
  97.  
  98. Now the module will be loaded into memory (if you've enough RAM for it) and
  99. played. But KARAOKE is not a simple player. If your module is called FOO.MOD
  100. and if a file called FOO.KDT is present in the same directory, it can be
  101. considered as a KARAOKE script file and used for displaying lyrics (see the
  102. paragraph 4 for the file structure). If the .KDT file is not present, module
  103. will be played normally as if it was played by a classical module player.
  104. Screen will be switched to VGA graphics mode (640x350, 16 colors) during song
  105. playback.You can stop music playback by pressing <ESC> or clicking left mouse
  106. button: Karaoke will come back to main menu.
  107.  
  108.  
  109. 4. KARAOKE SCRIPT FILES
  110.  
  111. KDT script files contain lyrics. You can find some .KDT file together with
  112. its .MOD file on several BBS or FTP sites. Script file is a simple text file.
  113. There's an example on this KARAOKE release, to use with a .MOD, also included
  114. in the package.
  115. All lines with a '#' or a ';' in the first column are considered as comments
  116. and will be ignored by KARAOKE. If no '#' (or ';') is present in the first
  117. column, text line is considered as a timer, and following text line as a
  118. lyrics string. The lyrics string corresponding to timer will be displayed
  119. when song relative timer reaches specified value.
  120.  
  121. EXAMPLE: We have the following script file:
  122.  
  123.                  ; SCRIPT FILE - EXAMPLE 1
  124.                  00:05
  125.                  That's only what I want
  126.                  00:08
  127.                  In this world
  128.                  00:12
  129.                  In this stupid world
  130.                  00:16
  131.                  Now that's time to go out
  132.                  00:19
  133.                  and tell you I love her....
  134.  
  135. First text row is a comment and will be ignored.
  136. Second and third text row tells KARAOKE to display the string "that's only what
  137. I want" when song timer reaches 00:05 value, that is, after five seconds song
  138. has started. In fact, KARAOKE will display three rows at a time, but first of
  139. them will be displayed in 'reverse' colors so it will be hilited. After three
  140. seconds (00:08), lines will be scrolled, so that the hilited row will be the
  141. second ("In this world"), the third and the fourth will be displayed using
  142. standard colors (that is, song text is 'scrolled' one line up). And so on.
  143. You can make your own Script Files. After you've listened a song and stored
  144. right timings on a paper, you can create your script file by placing all
  145. lyrics phrases corresponding to right timings. It could take a while, but you
  146. can speed up this procedure, by using one of utilities provided with KARAOKE
  147. (see par. 6)
  148.  
  149.  
  150. 5. LIMITATIONS
  151.  
  152. - KARAOKE needs a 80386 PC to run, then users having a 8086 or a 80286 should
  153.   to update their computer in order to use it.
  154. - You can have several problems when you try to play modules larger than 350k.
  155.   Then, if no sound is heard, or a 'allocation error' message is displayed,
  156.   probably the module is larger than available memory.
  157. - The maximum number of lyrics phrases in a song must be 500. I think that's
  158.   enough for most of the songs (A song having three verses, one bridge and
  159.   three chorus, uses about 100 phrases).
  160. - Be sure lyric phrases aren't longer than 50 chars or text will go out of the
  161.   screen. Also, lyric phrases shouldn't be longer than 70 chars or system may
  162.   crash.
  163.  
  164.  
  165. 6. UTILITIES
  166.  
  167. Distribution disk contains also other programs you can find useful.
  168.  
  169. -KARGRAB.EXE : This is an event capture for KARAOKE. If you have lyric text,
  170.                load your module in this utility, then press space every time
  171.                you want to insert a new 'phrase' in the script file. When you
  172.                press space, current song time will be stored in a file called
  173.                like the module but with '.KTM' extension. When you've stored
  174.                up all song timings, press <ESC> key. Now, load .KTM file into
  175.                a text editor, them add all lyrics phrases manually. You can
  176.                save result file by using a .KDT extension. If you've already
  177.                lyrics stored in a file, you can use KARFC.EXE described below.
  178.                If some error will occur during playback (eg. phrases not cor-
  179.                responding to timings), verify your song text file and correct
  180.                wrong timings manually (using a text editor). If you are not
  181.                able to find an error cause on the song text file, rerun KARGRAB
  182.                and make the timing file again.
  183.  
  184. -KARFC.EXE   : If you've a lyrics on a file, you can automatically merge it
  185.                to a file created with KARGRAB.EXE. The lyrics must have same
  186.                name of the timing file, but the extension must be .KLR. The
  187.                result file will have a .KDT extension, so that, if everything
  188.                goes well, you can use it directly with KARAOKE. If number of
  189.                timings don't correspond to numbers of phrases, something went
  190.                wrong, you can notice it if some phrase don't have a correspon-
  191.                dent timing in the .KDT, or vice versa. In such case, verify
  192.                where is the possible  error position, then run KARGRAB again,
  193.                paying attention to THAT position. You can also backup old
  194.                .KTM file, so you can compare both files and reduce your work.
  195.                If you notice you forgot only one timing (it's the most pro-
  196.                bable case), you can backup your old .KTM file, rerun KARGRAB
  197.                (or KARAOKE directly), pay attention only to event you forgot
  198.                previous time and edit timing file so that time will be reduced
  199.                a lot.
  200.  
  201. -PLAYMOD.EXE : plays a module file in background mode on a fast computer. You
  202.                must specify a file name and a frequency mix rate on the command
  203.                line. Module will be loaded into memory, then COMMAND.COM will
  204.                be launched allowing you to work in DOS mode. Free memory can
  205.                depend especially from module length. Type EXIT to stop music.
  206.                Please don't use a Memory Manager with this utility. If one is
  207.                installed, your system may crash. Use a frequency mix rate in
  208.                the range 5000-16000, based on computer you have. You can use a
  209.                80286 processor in order to run this utility, but your computer
  210.                can hang if it's not enough fast.
  211.  
  212.  
  213. 7. HISTORY
  214.  
  215. Version 2.50  (11/22/93)
  216.  
  217.         + New Graphic Environment
  218.         - Removed PC-Speaker and LPT1 Device support.
  219.  
  220. Version 2.00  (05/31/93)
  221.  
  222.         + Changed Module Playing Routines
  223.         + Added STM / 8CM / 6CM / S3M / AMF support
  224.         + Added module informations on the screen
  225.         - 286 support is down (KARAOKE runs only on 386/486 machines now)
  226.  
  227. Version 2.00ß (05/01/93)
  228.  
  229.         + Karaoke's desktop is totally changed by using VGA graphic support.
  230.         + Added a file requester in order to 'pick' a module.
  231.         + Fixed some bug to PLAYMOD (v1.1 released).
  232.  
  233. Version 1.01  (12/02/92)
  234.  
  235.         + First release available via FTP
  236.         + Fixed a bug in the timing counter
  237.         + Fixed other minor bugs.
  238.  
  239. Version 1.00  (11/29/92)
  240.  
  241.         + First release.
  242.  
  243.  
  244. 8. LAST REMARKS
  245.  
  246. The program is totally freeware. You can copy and distribute it. If you're
  247. interested to following releases, you can mail me. No part of this program can
  248. be modified in no way. All KARAOKE features are copyrighted by Davide Guida,
  249. except for playing routines, making part of Otto Chrons' DSMI package. KARAOKE
  250. is available on cs.uwp.edu Anonymous FTP site. You can find it on some other
  251. Anonymous FTP sites too, but you must look for it. You should find some .KDT
  252. file in the /pub/music/lists/btl/mods directory, based on Debbie Gibson MOD
  253. files uploaded here.
  254.  
  255.  
  256. 9. E-MAIL TECHNICAL SUPPORT
  257.  
  258. KARAOKE technical support is available also via E-MAIL, by writing to:
  259.  
  260. Davide Guida
  261. progetto@csdux01.cised.unina.it
  262.  
  263. (it's good if you specified receiver name, 'cause this e-mail address belongs
  264.  to a programming team and NOT to a single person)
  265.  
  266. If E-MAIL fails, for some cause, you can TELNET to csdux01.cised.unina.it on
  267. port 25 and use the SENDMAIL port directly. Here's the exact procedure (all
  268. sentences after '>' must be typed from your terminal, all sentences included
  269. in '<' and '>' must be substituted by true text)
  270.  
  271.                     telnet> open csdux01.cised.unina.it 25
  272.                     Trying...
  273.                     Connected to csdux01.cised.unina.it
  274.  
  275.                     csdux01 SENDMAIL port ready.
  276.  
  277.                     >MAIL FROM: <your complete e-mail address>
  278.                     >RCPT TO: progetto
  279.                     >DATA
  280.                     ><your mail>
  281.                     >.
  282.                     >QUIT
  283.  
  284. csdux01.cised.unina.it is mapped to numeric address 192.132.34.12
  285.  
  286.  
  287. 10. DGS PRODUCTS
  288.  
  289. - A Protracker Module collection is available by DGS. You can mail me in
  290.   order to know how you can have it. The collection contains some popular
  291.   songs. Also, a Debbie Gibson's module collection is available for her fans.
  292.   This collection is available on cs.uwp.edu (/pub/music/lists/btl/mods)
  293.   and info.brad.ac.uk (/misc/mods/debbie) anonymous ftp sites.
  294.  
  295. - The Postering Image collection is available by DGS. It includes a freeware
  296.   image viewer in order to display these images. You can find some image
  297.   also on cs.uwp.edu picture directories. They have .HS2 extension.
  298.  
  299. - MultiPlayer Professional Release 2.10 is distributed in the public domain.
  300.   It's a digital/fm/sample player for several sound devices. It requires 386
  301.   or 486 processors. LZH/ZIP/ARC/PAK archives are also used. A Virtual DOS
  302.   Shell is available during module playback.
  303.  
  304.